🚀 Getting Started

Quick Start

Deploy your first AI chatbot in under 5 minutes. This guide walks you from zero to a live, embedded bot on your website.

Prerequisites

A ModelPilot account — sign up free, no credit card required
An API key from at least one provider (OpenAI, Anthropic, Google, or Groq)
A website where you can paste a <script> tag (optional for testing)

Step 1 — Connect an AI provider

💡

If you want to start for free, use Groq (14,400 free requests/day) or Ollama (fully local, no key needed).

Go to AI Providers

In the dashboard sidebar, click AI Providers.

Click Connect on your provider

Choose OpenAI, Anthropic, Google AI, Groq, or any of the 8 supported providers.

Paste your API key

Keys are AES-256 encrypted at rest and never logged or shared.

Step 2 — Create a chatbot

Go to Chatbots → + New Chatbot

Give it a name (e.g. "Support Bot") and select your AI model.

Write a system prompt

Tell the bot who it is and how to behave. Example: "You are a helpful support assistant for Acme Corp. Be concise and accurate."

Test in the preview

Use the Test Preview tab to chat with your bot in real-time before deploying.

Step 3 — Upload knowledge

Navigate to Knowledge Base and upload your documents. Supported formats:

PDF — product manuals, FAQs, policies
DOCX / TXT / CSV / Markdown — any plain-text content
URL scraping — paste any URL to scrape and chunk
FAQ editor — type Q&A pairs directly

⚡

Documents are automatically chunked into ~256-token segments, embedded using text-embedding-3-small, and stored in Qdrant. Retrieval happens via semantic search at query time.

Step 4 — Embed on your website

Go to Embed Widget, customise the appearance, then copy the snippet:

html

<!-- ModelPilot AI Widget -->
<script>
  window.ModelPilotConfig = {
    botId: "bot_xxxx",
    accent: "#EA580C",
    position: "bottom-right",
  };
</script>
<script src="https://cdn.modelpilot.ai/widget.js" async></script>

✅

Paste this before </body> on any HTML page. The widget is vanilla JS, <4KB gzipped, with no framework dependencies.

Using the REST API

You can also send messages programmatically using the REST API. First, generate an API key from API Keys:

bash

curl -X POST https://api.modelpilot.ai/v1/chat/bot_xxxx \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "How do I reset my password?",
    "session_id": "user_session_abc",
    "stream": true
  }'

API Parameters

Parameter	Type	Required	Description
message	`string`	✓	The user's message
session_id	`string`	✗	Persistent session identifier for conversation history
stream	`boolean`	✗	If true, streams tokens via Server-Sent Events
user_identifier	`string`	✗	Email or ID of the end user for analytics

← Previous Introduction Next → Chatbots